hilitedButtonID

Type

property

Summary

Specifies which button in a group is currently highlighted.

Syntax

set the hilitedButtonID of <group> to <buttonID>

Description

Use the hilitedButtonID property to change the current setting in a radio-button cluster.

The hilitedButtonID specifies which button in a group is currently highlighted. If the hilitedButtonID of a group is zero, none of the buttons in the group is currently highlighted.

Setting the hilitedButtonID of a group sets the hilite property of the rest of the buttons to false.

The hilitedButtonID property is most useful in radio-button clusters. In a radio-button cluster, only one button can be highlighted at once: clicking another button unhighlights the first one. The radioBehavior property of a group of buttons specifies whether they act as a radio-button cluster.

The hilitedButton, hilitedButtonName, and hilitedButtonID properties all refer in different ways to the same button. When any of them changes, all of them change.

Examples

set the hilitedButtonID of group "Options" to 342

set the hilitedButtonID of group 1 to the short ID of the mouseControl

Related

command: hilite, group

glossary: property, highlight, radio button

keyword: button

object: button

property: radioBehavior, hilitedButton, hilitedButtonName, ID

Compatibility and Support

Introduced

LiveCode 1.0

OS

mac

windows

linux

ios

android

Platforms

desktop

server

mobile